home *** CD-ROM | disk | FTP | other *** search
/ Delphi Magazine Collection 2001 / Delphi Magazine Collection 20001 (2001).iso / DISKS / ISSUE13 / COMPRESS / COMPRESS.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-08-09  |  9.4 KB  |  238 lines

  1.               TCompress Component Set V2.5
  2. File and Database Compression Components for Delphi 1.0 and 2.5
  3.  
  4.           Copyright (c) 1995, 1996  Peter Hyde
  5.           South Pacific Information Services Ltd
  6.         Fax: +64-3-384-5138  Email: peter@spis.co.nz
  7.          Web:  http://www.spis.co.nz/compress.htm
  8.  
  9.          These components are fully functional SHAREWARE.
  10. >>>>> If you ordered the registered version of TCompress, see REGINFO.TXT
  11.  
  12. You are encouraged to pass them on, upload them to BBS, Web and 
  13. ftp sites and generally spread them around as much as you can
  14. -- but please keep all the files together!
  15.  
  16. If you find TCompress useful, registration will get you the
  17. latest version, a personal ID to eliminate the occasional
  18. reminder message, access to our highly regarded (and, I have
  19. to say it, rarely needed) support AND a nice warm
  20. fuzzy feeling.
  21.  
  22. Registration details are at the end of this file.
  23.  
  24. ===== PLEASE SEE COMPRESS.HLP FOR MUCH MORE INFORMATION =====
  25.  
  26. 1. Key features:
  27.  
  28. * Support for Delphi 1.0 (16-bit) and Delphi 2.0 (32-bit)
  29. * NATIVE Delphi compression -- no mucking about with DLLs,
  30.   VBXes et al
  31. * Multi-file compressed archives using the TCompress component
  32. * Database BLOB (memo, image) compression with TCDBMemo and
  33.   TCDBimage
  34. * In-memory compression using streams
  35.   (file/memory/blob/resource<-->file/memory/blob)
  36. * Event hooks for customizable user interaction
  37. * Built-in RLE (Run-Length Encoding) and LZH
  38.   (Lempel-Ziv-Huffman) compression
  39. * Easy to add your own custom compression routines at any time
  40. * Functions and examples to support compressed resources
  41.   and self-extracting EXEs
  42. * Key-based compressed data protection
  43. * Loads of example source included
  44. * Full component source code available
  45.  
  46.  
  47. 2. Installation:
  48.  
  49.     Quick Start (for people in a hurry):
  50.  
  51. *   Install COMPRESS.DCU and COMPCTRL.DCU into your component
  52.     library
  53. *   Load the COMPDEMO project, compile and run it (if you are
  54.     using Delphi 1.0, see the notes at the top of COMPMAIN.PAS)
  55. *   Examine COMPMAIN.PAS for numerous examples of how to use
  56.     the compression components
  57.  
  58.  
  59.     Full Installation Instructions (for careful people):
  60.  
  61. *   32 bit components are in the main archive, 16 bit DCUs in
  62.     COMP16.ZIP
  63.  
  64. *   BACKUP your COMPLIB.DCL file
  65.  
  66. *   Also BACKUP the Delphi's DEMOS\DATA\BIOLIFE.* files, as
  67.     this database is used by COMPDEMO to show off blob
  68.     compression
  69.  
  70. *   Put COMPRESS.DCU/.DCR and COMPCTRL.DCU/.DCR in a directory
  71.     on Delphi's Component Library Search path
  72.  
  73. *   Select Install Components, then click Add and type
  74.     COMPRESS. Click  Add again and type COMPCTRL. Click OK.
  75.  
  76. *   All being well, a rebuild will take place and a new
  77.     Compress tab will appear on your component palette. This
  78.     contains the TCompress, TCDBMemo (Compressed Database Memo)     and TCDBImage (Compressed Database Image) components.
  79.  
  80. *   Ensure the DBDEMOS alias is pointing to the directory
  81.     containing the BIOLIFE database (Delphi installs this, so
  82.     it should be fine)
  83.  
  84. *   Load the COMPDEMO project and run it. (if you are
  85.     using Delphi 1.0, see the notes at the top of COMPMAIN.PAS)
  86.  
  87. Note: TCompress and its companions provide very comprehensive
  88. data compression capabilities. Most developers might only need
  89. to drop a TCompress component on their form and call its ExpandFile/CompressFile methods in order to create and work with their own multi-file archives...
  90.  
  91. Others might drop TCDBMemo/TCDBImage components on as well and simply interact with them to have text and picture data automatically compressed when they are stored in a database.
  92.  
  93. ...and some developers might use the TCBlobfield class to store all kinds of data (sound, numbers, video etc) directly into compressed database blobs (see the BLOB.DPR demonstration for an example of this).
  94.  
  95.  
  96. 3.  Installing Help (for integrated help while running Delphi):
  97.  
  98. *   Put COMPRESS.HLP in Delphi's BIN directory
  99. *   Put COMPRESS.KWF file in into Delphi's HELP directory
  100. *   Run the HELPINST utility, and select
  101.     FILE|OPEN|BIN\DELPHI.HDX.
  102. *   Click the + icon and select COMPRESS.KWF.
  103. *   Select File|Save to write the updated DELPHI.HDX file,
  104.     then exit.
  105. *   You should now be able to access TCompress help from within 
  106.     Delphi, e.g. by pressing F1 while the cursor is in the
  107.     RegName property or OnCheckFile event.
  108.  
  109.  
  110. 4. File list:
  111.  
  112. COMPRESS.DCU   TCompress component (Delphi 2.0 version)
  113. COMPONLY.DCU   Special version of TCompress -- doesn't
  114.                require BDE!
  115. COMPRESS.DCR   Component palette icon for TCompress
  116.  
  117. COMPCTRL.DCU   TCDBImage, TCDBMemo and TCBlobField components
  118. COMPCTRL.DCR   Component palette icons for the above
  119.  
  120. COMP16.ZIP     As above, but for Delphi 1.0 (16-bit versions)
  121.  
  122. COMPRESS.HLP   Complete help file for TCompress component set
  123. COMPRESS.KWF   Keyword file to integrate into Delphi's help
  124.  
  125. COMPDEMO.DPR   TCompress demonstration project file
  126. COMPMAIN.PAS   Source for the above (many examples here!)
  127. COMPMAIN.DFM   Form for the above
  128.  
  129. BLOB.DPR       Example project for storing miscellaneous
  130. BLOBDEMO.PAS   data (e.g. arrays, sound, AVI etc) in a
  131. BLOBDEMO.DFM   compressed database blob. See comments
  132.                at the top of BLOBDEMO.PAS.
  133.  
  134. RLECOMP.PAS    Example source showing how to implement a custom
  135.                compression handler (for RLE in this case)
  136.  
  137. ARC2MEM.PAS    Example of expanding data directly from an
  138.                archive to memory (drops into COMPMAIN.PAS)
  139.  
  140. ARC2BLOB.PAS   Example of copying compressed data directly
  141.                from a file archive to a  compressed blob
  142.                WITHOUT expanding it first (drops into COMPMAIN)
  143.  
  144. SELFEXTR.DPR   Example projects for creating self-extracting
  145. SELFEXTF.PAS   archives -- in one case with a form providing
  146. SELFEXTF.DFM   a user interface, in the other with minimum
  147. DOINSTAL.PAS   possible overhead by using no form.
  148. SELFXSML.DPR   Both projects tested with Delphi 2.0 only.
  149. COMP_RES.RC
  150.  
  151. BMTEST.DPR     Example project for storing and loading BMTESTF.PAS    compressed bitmaps from EXE or DLL resources
  152. BMTESTF.DFM    instead of using external archives or
  153. BITMAPS.RC     regular (uncompressed) resources
  154.  
  155. HISTORY.TXT    Development history
  156.  
  157. README.TXT             This file
  158.  
  159.  
  160. 5. Synopsis (for Web/BBS listings etc):
  161.  
  162. Filename: COMPRESS.ZIP   (File date: 9-August-96  Time: 2:50)
  163. 1 line description:
  164. TCompress v2.5 File and Database Compression Components for Delphi v1.0/2.0
  165. Uploader name & email: Peter Hyde, peter@spis.co.nz
  166. Surface address: SPIS Ltd PO Box 19-760, Christchurch, NEW ZEALAND
  167. Special requirements: Delphi v1.0 or v2.0
  168. Shareware payment required from private users: $NZ 70 (about $US 50)
  169. Source included: No (available separately)
  170. Size zipped / original (in Kb): 180 / 370
  171.  
  172. 10 line description:
  173.  
  174. TCompress provides native Delphi components for the creation of 
  175. multi-file compressed archives, as well as database, file,
  176. resource and in-memory compression using Delphi streams.
  177. Two compression methods (RLE and LZH) are built in, with
  178. "hooks" for the easy addition of custom compression formats.
  179.  
  180. TCompress also includes drop 'n play components for automatic
  181. database blob, image and memo compression, based on Delphi's
  182. TDBMemo and TDBImage components.
  183.  
  184. Images compress by up to 98% when using LZH, hence there is a
  185. massive saving in disk space and disk or network access when
  186. using these components.
  187.  
  188. TCompress comes with an extensive demonstration, many source
  189. examples and Delphi-compatible help and keyword files. Supports Delphi 1.0 and 2.0.
  190.  
  191.  
  192. 6. Registration
  193.  
  194. *** If you are a registered V2.0 user, the V2.5 DCUs can be used immediately -- no further payment required.
  195.  
  196. *** If you are are registered V1.5 user, please see the special upgrade pricing in the Registration section of COMPRESS.HLP.
  197.  
  198. Full registration information is in COMPRESS.HLP. When you
  199. register, you will receive an updated version (if any), and
  200. a personal registration ID to eliminate the occasional reminder dialog.
  201.  
  202. On registration, you can optionally also order the source code
  203. of the TCompress component (COMPRESS.DCU) and/or the
  204. TCDBImage/TCDBMemo components COMPCTRL.DCU). Please specify
  205. when ordering if you also want these.
  206.  
  207. Registration prices:
  208.  
  209. Product Registration/License:   $NZ 70 (about $US 50)
  210. Optional Compress source (add): $NZ 55 (about $US 37)
  211. Optional Compctrl source (add): $NZ 45 (about $US 30)
  212. Optional airmailed disk  (add): $NZ  5 (no charge if emailed)
  213.  
  214. Payments may be made by Mastercard or Visa (please specify card 
  215. number, expiry date, and name of holder). You may also pay by a
  216. bank check in your own currency to the equivalent value at
  217. current exchange rates. We do NOT accept Compuserve SWREG
  218. registrations.
  219.  
  220. Please print or email the form in COMPRESS.HLP to register
  221. your version.
  222.  
  223. Contact: SPIS Ltd, PO Box 19-760, Christchurch, New Zealand
  224. Fax: +64-3-384-5138           Email: peter@spis.co.nz
  225.  
  226.  
  227. **** Other components you should check out:
  228. TSegCompress by Ken McClain (kmcclain@mindspring.com). TSegCompress builds on TCompress to allow you to create segmented archives (e.g. for saving one archive on several floppies).
  229.  
  230. See: http://www.mindspring.com/~kmcclain/index.htm to download TSegCompress.
  231.  
  232.  
  233. *** For late-breaking information, new versions, new components, tips and tricks,
  234.     visit our Web page at
  235.     http://www.spis.co.nz/compress.htm
  236.  or http://super.sonic.net/ann/delphi/more/tcompres/
  237.  
  238.